home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 081 / omlrun14.arc / OMAILRUN.DOC next >
Encoding:
Text File  |  1988-01-09  |  4.2 KB  |  129 lines

  1.  
  2.                    OMAILRUN Version 1.4
  3.               Copyright 1987 Benny N. Ormson
  4.  
  5.  
  6.  First things first:
  7.  
  8.   This is FREEWARE meaning you can have it free of charge.  There
  9.   is no fee required or requested.  There is no gaurantee or
  10.   warranty.  Bugs and enhancement requests may be sent but there
  11.   is no guarantee that they will be addressed.  Use of the software
  12.   is at your own risk.  This program and documentation is copyrighted.
  13.   All rights are reserved.  This product may be given away freely but
  14.   may NOT be sold or provided with any type of fee attached.  This
  15.   document must accompany any copies made.
  16.  
  17.  Configuration:
  18.  
  19.   This software has been tested on an IBM PC/XT running DOS 3.1
  20.   and OPUS 1.03a.  No other configurations have been tested.
  21.  
  22.  
  23.  What is here:
  24.  
  25.   OMAILRUN.DOC - You're reading it.
  26.   OMAILRUN.EXE - Executable file.
  27.  
  28.  
  29.  What it does:
  30.  
  31.   There must be a dozen mail check utilities for FIDO and OPUS.  I
  32.   looked at at least a half a dozen myself.  I couldn't find one
  33.   which ran the way I wanted for my OPUS so I wrote this one.  It
  34.   is relatively simple and has limited options, but it is FAST.
  35.  
  36.   What it does in a nutshell is notify callers of unread mail they
  37.   have waiting.  Nothing more and nothing less.  It has a few
  38.   benefits over some of the other mail checkers such as:
  39.  
  40.   1) Does NOT require a bunch of support files.
  41.  
  42.   2) There is only one program to run instead of 2 or 3.
  43.  
  44.   3) Since custom welcome .xBS files are not used by this
  45.      program, they are still available for your use.
  46.  
  47.   4) It is simple and easy to install and use.
  48.  
  49.   5) Will not list mail for a caller that may be found in a
  50.      message area which he/she does not have access to.
  51.  
  52.   6) Messages to "sysop" are included in the display for user 0.
  53.  
  54.   7) The gen option run may be executed at any time, even while
  55.      OPUS is up, via another multitasking partition.
  56.  
  57.  
  58.   Then again there are a few limitations also:
  59.  
  60.   1) It is assumed that the SYSOP user.bbs record is record 0.
  61.  
  62.   2) There is a maximum limit of 1000 users in your user.bbs file.
  63.  
  64.   3) The maximum number of unread messages to these users is 4000.
  65.  
  66.  
  67.  
  68.  
  69.  Installation instructions:
  70.  
  71.    Copy OMAILRUN.EXE to your OPUS directory.
  72.  
  73.    Add two lines to your welcome.xBS file(s) as follows:
  74.  
  75.     ^OCOmailrun
  76.     ^OSC:\Opus\Omailrun
  77.  
  78.    Add the OMAILRUN gen command to your OPUS batch file after
  79.    your message area maintenence programs have executed.  The
  80.    format for this command is as follows:
  81.  
  82.      OMAILRUN GEN [-opt] user.bbs area# [area# ...]
  83.  
  84.     Example:  OMAILRUN gen myusers.bbs 0 1 8 12 43
  85.  
  86.     Example:  OMAILRUN gen -s myusers.bbs 0 1 8 12 43
  87.  
  88.     -opt - Options:  -s   Exclude messages to "SYSOP".
  89.     gen - The generate option is selected.
  90.     myusers.bbs - The name of your opus user.bbs file.
  91.     Process message areas 0, 1, 8, 12, 43
  92.  
  93.  
  94.   Method of operation:
  95.  
  96.    During you maintenece batch processing OMAILRUN is executed
  97.    which scans your user.bbs and all selected message areas.  It
  98.    then creates or replaces the message base file OMAILRUN.MSG
  99.    in your OPUS directory.
  100.  
  101.    When a callers comes online, your welcome bbs/gbs file will
  102.    execute OMAILRUN.  This execution reads the message base file
  103.    OMAILRUN.MSG and creates/replaces a file called OMAILRUN.BBS.
  104.    This file contains the display of waiting messages.  Your
  105.    welcome bbs/gbs file then hands off to OMAILRUN.BBS which
  106.    results in the display of messages to the caller.
  107.  
  108.  
  109.  Revision Log:
  110.  
  111.   11-03-87 Version 1.1:  Add ^A to "no mail" message.
  112.  
  113.   12-11-87 Version 1.2:  Add date and timestamp when mailrun was done.
  114.                          Add -s option to exclude "sysop" messages.
  115.  
  116.   12-25-87 Version 1.3:  Remove restriction that message directory be
  117.                          on the default drive.
  118.  
  119.   01-09-88 Version 1.4:  Eliminate compiler warning messages at /W3 and
  120.                          reduce optimization level to avoid some
  121.                          possible problems which have been reported with
  122.                          large user.bbs files.
  123.  
  124.  
  125.                    Benny N. Ormson
  126.          Air Traffic Control BBS - Node 147/16
  127.                    405-752-9760
  128.  
  129.